Home page at 90% instead of a smaller redesign, and In a Nutshell fills its gaps - #175
Merged
Merged
Conversation
The first pass cut too hard. Chasing "fits a 13" laptop" took the hero type to 40px and the cards to 16px of padding — 750px tall, and a different, smaller page than the one it started from. This is the same page at nine tenths of the theme's numbers, type included, so every proportion is preserved: it is what a reader gets by pressing ctrl-minus once, written down. About 970px, which leaves the whole signpost on one screen on a large display and still scrolls a little on a short one — the trade is deliberate, and stated in the file. One number is not scaled: the 128px gap under the last block, now 48. The theme spends it assuming more page follows; here a footer does. Nothing is visible in that space either way, so it costs nothing to look at and saves 80px on a short window. The footer rule from the first pass is gone with it — a site-wide change for 3px was not worth carrying. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01HiTYuWrPNZX4zNQgrEzpsf
The page pitched the framework well and left a first-time reader with four questions it never answered. **What does an app look like?** The only visual was a message box in a code fence. The walkthrough's finished app — a selection screen, a table, a dialog — now sits under it, with the one link the page was missing: the Tutorial. **How does it actually work?** "Thin frontend" and "data embedded in XML views" describe the result, not the mechanism. A new section says it: the view is built in ABAP, every interaction is a fresh call into main( ), nothing survives on the server between two clicks because the app serializes itself into the roundtrip — stateless by default, with the stateful escape hatch named. **Where does it NOT fit?** An overview that only lists strengths is one a reader discounts. The three cases from UI5 Over-the-Wire — heavy interactivity, offline, strictly separated teams — are now stated on the page that people read first, next to what it IS for. **What runs it?** ABAP releases were precise; UI5 was not mentioned at all. The default OpenUI5 CDN bootstrap, pinning, hosting it on your own system, 1.71 as the oldest supported release and the UI5 2.x testing now have a subsection. Four claims also got the pages that back them: Performance, Security (plus Authorization, and the fact that input still arrives from a browser), Add-ons. Tooling and the AI workflow get a section — the linter, the extension and the MCP server were invisible here. Release Notes and Deprecations back "use it in production", and Who Uses abap2UI5 backs "used worldwide". A `description` in the frontmatter gives the site's most-shared page a real preview card instead of the site-wide default. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01HiTYuWrPNZX4zNQgrEzpsf
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Follow-up to #174, which merged before these two commits existed. #174 shipped the home page at sizes that read as a different, smaller page; this corrects that, and fixes the overview page it points at.
Home page: nine tenths, not a redesign
#174 chased "fits a 13-inch laptop" and got there by cutting hard — hero type to 40px, cards to 16px of padding, 750px tall. The proportions changed, and the front door stopped looking like itself.
This is the same page at nine tenths of the theme's own numbers, type included — what a reader gets by pressing ctrl-minus once, written down. Hero 50/58 instead of 56/64, tagline 22/32, cards 22px of padding, icon 43px, buttons scaled to match the headline above them.
Measured at a 1440-wide window: 1152px → 993px (the first attempt was 750px). A tall window shows the whole signpost; an 800px one still scrolls a little, and that trade is stated in the file.
One number is deliberately not scaled: the 128px gap under the last block is 48. Nothing is visible in that space either way — when the page is shorter than the window the footer sits at the bottom regardless — so it costs nothing to look at and saves 80px on a short window. The site-wide footer-padding rule from #174 is dropped; a global change for 3px was not worth carrying.
In a Nutshell: what a first-time reader was missing
docs/get_started/about.mdpitched the framework and left four questions unanswered:main( ), and nothing survives on the server between two clicks because the app serializes itself into the roundtrip — stateless by default, with the stateful escape hatch named.Four claims also got the pages that back them (Performance, Security plus Authorization, Add-ons), Tooling and the AI workflow get a section, Release Notes and Deprecations back "use it in production", Who Uses abap2UI5 backs "used worldwide", and a
descriptionin the frontmatter gives the most-shared page a real preview card.Verification
npm run checkgreen on the rebased branch —test,check:version,docs:build(dead-link checking validates every new internal link),check:examples.check:samplesskips without a samples checkout, as it does locally; CI runs it for real, and no page with a Working Samples block is touched.Home-page heights measured in a headless browser at 1440×800, 1470×830, 1512×860 and 1280×720.
🤖 Generated with Claude Code
https://claude.ai/code/session_01HiTYuWrPNZX4zNQgrEzpsf
Generated by Claude Code